home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / print / cal13.arj / CAL.DOC < prev    next >
Text File  |  1992-01-16  |  11KB  |  248 lines
  1.  
  2.  
  3.        Original Documentation written by : Leonard N. Devoe
  4.        Revisions to Documentation by     : Dan Devoe  
  5.  
  6.  
  7.                               CAL.EXE (Calendar)
  8.                               ══════════════════ 
  9.  
  10.             This program, which was  written in  Turbo C++ v1.01 contains 
  11.        ACCURATE  calendars  from the  year 1 through 65,535.  The program     
  12.        has  been recompiled under  Turbo  C++ v1.01  in order to create a
  13.        single  executable file, viz. CAL.EXE, which  is  over 50% smaller
  14.        than the Pascal version (with  additional  features). The original
  15.        version contained two files: CAL.COM & CAL.000  both of which were
  16.        needed if a leap year was  accessed.  The year, which is converted
  17.        to an integer, now  accepts  values up to  the year  65,535; since 
  18.        negative  values are not  allowed, the year  is now  treated as an
  19.        unsigned integer.  Why waste 32,768 perfectly good years? :-)
  20.  
  21.             The syntax for the program is merely to enter the command  at 
  22.        the MS-DOS prompt followed by a space and the desired year, e.g.  
  23.  
  24.  
  25.                                   C> Cal 1992
  26.  
  27.             If the year is not entered on the command line, the   program 
  28.        will  prompt for the year. The year must be between 1 and   65535; 
  29.        if it isn't, an error message will be displayed for  approximately 
  30.        one and a half seconds after which the program will again   prompt 
  31.        for  the year. The program will display six months of the year  on 
  32.        each of two screens.  
  33.  
  34.             Because  of  the size of this program, it is  probably   best 
  35.        suited for use on a hard-disk system where it can remain  resident 
  36.        without  an appreciable drain on disk space .
  37.  
  38.             This  program  is  similar  to the  one  used  in  the   Unix 
  39.        operating system with one major exception, that system adopts  the 
  40.        Gregorian  calendar  in  1752. This was done  in  all   likelihood 
  41.        because  of  the  fact that the United States  was  part  of   the 
  42.        British Empire when the switch was made and therefore many of  the 
  43.        dates  in our colonial history and prior are entrenched with   the 
  44.        British.  However, as you will note in the abridged history,  most 
  45.        dates in American history have been converted to Gregorian  dates, 
  46.        therefore, there isn't any logical reason not to make the   switch 
  47.        to  the  Gregorian calendar when it was first adopted, namely   in 
  48.        1582, which is the year that this program uses.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                     - 1 -
  62.  
  63.  
  64.  
  65.  
  66.                        ABRIDGED HISTORY OF THE CALENDAR 
  67.                        ════════════════════════════════ 
  68.  
  69.  
  70.                                 JULIAN CALENDAR 
  71.                                 ─────────────── 
  72.             The  first  modern Calendar was put into use in 45  B.C.   by 
  73.        Julius  Caesar who decreed that henceforth there should be   three 
  74.        years  of  365  days  each and then one  year  of  366  days,   in 
  75.        perpetual  cycle. This became known as the Julian  Calendar,   and 
  76.        began the custom we still observe today of adding one day to   the 
  77.        month of February every fourth year, or Leap Year as it is known.  
  78.  
  79.             Even though the Julian Calendar was an enormous   improvement 
  80.        over all previous systems, it still was not completely   accurate.  
  81.        Since  there are approximately 365 1/4 days in a solar  year,  the 
  82.        Julian Calendar was reasonably satisfactory for many years -   but 
  83.        there are not exactly 365 1/4 days in a year. The exact solar year 
  84.        consists  of  365 days, 5 hours, 48 minutes,  47.8  seconds.   The 
  85.        difference  of  about eleven minutes becomes appreciable  in   the 
  86.        course of several centuries.  
  87.  
  88.  
  89.                               GREGORIAN CALENDAR 
  90.                               ────────────────── 
  91.             The  final  Calendar  correction was done in  1582  by   Pope 
  92.        Gregory  XIII,  and the corrected Calendar that we use  today   is 
  93.        called the Gregorian Calendar. First, in order to make up for  all 
  94.        the days which had accumulated since the beginning of the   Julian 
  95.        Calendar,  Pope Gregory XIII decreed the elimination of  10   days 
  96.        from the year 1582. This was done, and in many countries the   day 
  97.        after October 4, 1582 became October 15, 1582.  
  98.  
  99.             Pope Gregory XIII also installed the Leap Year rule which  is 
  100.        now  in effect and which will serve us for more than  a   thousand 
  101.        years hence. The Gregorian Leap Year rule provides for dropping  a 
  102.        day from every centesimal year (ending in 00) whose number  cannot 
  103.        be  divided  by 400. Thus, a day was dropped in the  years   1700, 
  104.        1800 and 1900. This meant that the years 1700, 1800 and 1900  were 
  105.        not Leap Years, i.e. had 28 days in February. The day will not  be 
  106.        dropped  in  the year 2000, so the month of February,  2000   will 
  107.        have 29 days. The error in our present Calendar is less than   one 
  108.        day  every 3000 years, so, although the Gregorian Calendar  is   a 
  109.        great improvement over the Julian Calendar, it still is not   100% 
  110.        accurate.  However,  the cesium atom clock  which  was   developed 
  111.        around 1950 is being used as a master clock and corrections   have 
  112.        been  made and will continue to be made to the  current   calendar 
  113.        which will give it an accuracy of as high as one second in  30,000 
  114.        years.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.           
  121.  
  122.  
  123.                                     - 2 -
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                          ADOPTION OF GREGORIAN CALENDAR 
  131.                          ────────────────────────────── 
  132.             Although the initial adoption of the Gregorian Calendar   was 
  133.        in 1582, its use was by no means universal. As might be  expected, 
  134.        the  first  countries to adopt the new  Calendar  were   primarily 
  135.        Roman  Catholic nations. Most Protestant countries did not   adopt 
  136.        the Gregorian Calendar until later.  
  137.  
  138.             The  American  Colonies made the switch in  1752,  when   the 
  139.        whole  British Empire changed. September 2, 1752 was followed   by 
  140.        September  14, 1752. Note that an eleven day adjustment  was   now 
  141.        needed, the Julian Calendar having added another day between  1582 
  142.        and   1752.   Dates   preceding   the   change   are     sometimes 
  143.        designated  OS for Old Style. Thus, George Washington's   birthday 
  144.        is  really February 11, 1732 (OS), and only after the  change   to 
  145.        the  Gregorian Calendar was his birthday established as   February 
  146.        22,  1732. Most dates in American History have been converted   to 
  147.        New  Style,  or Gregorian dates. Other countries have  been   even 
  148.        slower  in adopting the new Calendar: Japan, 1873;  China,   1912; 
  149.        Soviet Union, 1918; Greece, 1924; Turkey, 1927.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.                           CREDIT WHERE CREDIT IS DUE...
  161.                           ═════════════════════════════
  162.  
  163.       I would like to thank the following people for making this program
  164.       possible -- they all played a role, no matter how small:
  165.            - Leonard N. Devoe, for original concept and design.
  166.            - Dianne Parisien, for giving me Turbo C++ for Christmas.
  167.            - Paul  Edwards, for  using his  non-leap-year  formula as  a
  168.              guideline to getting my formula working properly (for  both
  169.              Gregorian and Julian years).
  170.            - Borland International, for producing Turbo C++.
  171.            - The computer science faculity  at Salem  State college  for
  172.              assisting me in my programming technique for the  past four
  173.              years.
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                                     - 3 -
  185.  
  186.  
  187.  
  188.  
  189.  
  190.                            PUBLIC DOMAIN & DISCLAIMER
  191.                            ══════════════════════════
  192.             This program was originally compiled under CP/M and placed in
  193.        the public  domain in March  of 1986.  The  source code  had  been 
  194.        slightly modified  and recompiled under MS-DOS and is being placed
  195.        in  the MS-DOS public domain on  May 19, 1987.  A  major  re-write
  196.        was  done using Turbo C++, completed on Jan 15, 1992, and released
  197.        as shareware on Jan 16, 1992.   This new version has the following
  198.        new features:
  199.             - Maximum year increased from 32,767 to 65,535
  200.             - Color added to make program look more "Professional"
  201.             - Previous/next years can be viewed after the current year is
  202.               displayed.
  203.             - Registration file ("Cal.Reg") added for registration ID.
  204.             - The program is now shareware; registration is $7.  However,
  205.               for every copy  of this program  that  is  registered  with
  206.               your  name, serial number, and registration code,  you will
  207.               receive a $2  commission, which will be sent to you at  the
  208.               end of each month.  Suppose 10 people register this program
  209.               one month, you will receive a  check for  $20.  $2  doesn't
  210.               sounds like a lot, but it can add up, and you will support-
  211.               ing the shareware concept.
  212.        Please do not alter lines one and two in the registration file, as
  213.        you will be jipping someone of a possible $2 commission (which, as
  214.        mentioned earlier, can add up --  how  would you  feel if  someone
  215.        altered your name?)  Keep the file "Cal.Reg" in the same directory
  216.        as your "Cal.Exe" file, and make sure  that that  directory is  in
  217.        your path.  Until you register this program, a special file called
  218.        "Register.Cal" will be created in your CURRENT  directory.  Please
  219.        load this form into an editor and complete if you wish to  support
  220.        the shareware conecpt.  If you don't have a printer, please  hand-
  221.        write the form EXACTLY as it appears in the file "Register.Cal".
  222.  
  223.  
  224.        The authors disclaims any liability or responsibility to any person
  225.        for any loss or damage alleged to be caused through the use of this
  226.        program.
  227.  
  228.  
  229.  
  230.        Leonard N. Devoe 70147,1113                  Dan Devoe 73030,446
  231.                              46 Buena Vista Avenue 
  232.                         Salem, Massachusetts 01970-1042 
  233.              (508) 744-3322                           (508) 745-1689
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.                                     - 4 -
  248.